home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / pbmpl91d.zip / PBMPLUS / MAN / PGMTOPBM.MAN < prev    next >
Text File  |  1993-01-08  |  2KB  |  68 lines
  1.  
  2.  
  3. pgmtopbm(1)                Unix Programmer's Manual                pgmtopbm(1)
  4.  
  5.  
  6. NAME
  7.      pgmtopbm - convert a portable graymap into a portable bitmap
  8.  
  9. SYNOPSIS
  10.      pgmtopbm [-floyd|-fs|-threshold |-dither8|-d8|-cluster3  |-c3|-cluster4|-
  11.      c4 |-cluster8|-c8] [-value val] [pgmfile]
  12.                                 ---   -------
  13.  
  14. DESCRIPTION
  15.      Reads a portable graymap as input.  Produces a portable bitmap as output.
  16.  
  17.      Note that there is no pbmtopgm converter, because  any  pgm  program  can
  18.      read pbm files automagically.
  19.  
  20. OPTIONS
  21.  
  22.      The default quantization method is boustrophedonic Floyd-Steinberg  error
  23.      diffusion  (-floyd  or  -fs).   Also available are simple thresholding (-
  24.      threshold); Bayer's ordered dither (-dither8) with a  16x16  matrix;  and
  25.      three  different  sizes  of  45-degree  clustered-dot  dither (-cluster3,
  26.      -cluster4, -cluster8).
  27.  
  28.      Floyd-Steinberg  will  almost  always  give  the  best  looking  results;
  29.      however,  looking  good  is  not  always  what  you  want.  For instance,
  30.      thresholding can be used in a pipeline with the pnmconvol tool, for tasks
  31.                                                      ---------
  32.      like  edge  and  peak  detection.   And  clustered-dot  dithering gives a
  33.      newspaper-ish look, a useful special effect.
  34.  
  35.      The -value flag alters the thresholding  value  for  Floyd-Steinberg  and
  36.      simple  thresholding.  It should be a real number between 0 and 1.  Above
  37.      0.5 means darker images; below 0.5 means lighter.
  38.  
  39.      All flags can be abbreviated to their shortest unique prefix.
  40.  
  41. REFERENCES
  42.      The only reference you need for this stuff  is  "Digital  Halftoning"  by
  43.      Robert Ulichney, MIT Press, ISBN 0-262-21009-6.
  44.  
  45. SEE ALSO
  46.      pbmreduce(1), pgm(5), pbm(5), pnmconvol(1)
  47.  
  48. AUTHOR
  49.      Copyright (C) 1989 by Jef Poskanzer.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                 26 July 1988                                 1
  67.  
  68.